home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / wildcat / omlcat.zip / OMLCAT.DOC next >
Text File  |  1992-02-26  |  5KB  |  96 lines
  1.                             OMLCAT v1.00
  2.                          Order of Merit List
  3.                                 for
  4.                        Wildcat v3.00 and above
  5.  
  6.                                 by
  7.                           Michael P. Kelly
  8. ---------------------------------------------------------------------------
  9. PURPOSE
  10.  
  11.         The purpose of this handy and colorful utility is to show your
  12. callers and you who are the top participating callers to your BBS.  The
  13. really nice part about this is that you get to set the criteria for what
  14. you consider "participation".  As sysops, we each have differing views on
  15. what makes the best caller in terms of participation.  Some like uploads,
  16. some like message, some like calls, whatever!  My program, based on your
  17. criteria, will calculate an overall score for each caller on your BBS and
  18. then list them in order.  Hence the Order of Merit naming.  It also allows
  19. your users to compete to get to the top of your listing.
  20.  
  21. INSTALLATION
  22.  
  23.         Place OMLCAT.EXE anywhere you like.  I personally prefer everything
  24. to be in its own directory for organizational reasons.  To get instructions
  25. you can merely run the program with no parameters.  All the info is right
  26. there for you!  However, I can explain it here too.  OMLCAT takes exactly
  27. six command line parameters, no more, no less.  I perform no fancy range
  28. checking on the parameters so I leave it up to you to not go crazy with the
  29. parameters.  The command line syntax is as follows:
  30.  
  31.         OMLCAT <up> <dn> <call> <msg> <listed> <path to makewild.dat>
  32.  
  33. Seems simple enough but let me explain just what it is looking for along with
  34. a few sample command lines.
  35.  
  36. <up> is the number of points you award per upload, INTEGER only
  37. <dn> is the number of points you award per download, INTEGER only
  38. <call> is the number of points you award per call, INTEGER only
  39. <msg> is the number of points you award per message posted, INTEGER only
  40. <listed> is the number of callers you want listed in the display file
  41. <path> is the COMPLETE path and filename for makewild.dat
  42.  
  43. Ok, now for my sample command line that I use on my BBS:
  44.  
  45.         OMLCAT 10 -1 2 2 10 \WC30\MAKEWILD.DAT
  46.  
  47. See how simple that was!  Now if you are the type who has to try using real
  48. numbers for the arguements, the program will crap out on you!  REMEMBER!!
  49. My program ONLY READS the user database file and no damage or loss of data
  50. can occur if it exists with an error!
  51.  
  52. DISPLAY FILE
  53.  
  54.         The display file written by OMLCAT utilizes Wildcat v3.0 screen
  55. display codes.  The file generated is called SCORE.BBS and will be created
  56. in the same directory that OMLCAT.EXE resides.  I prefer this approach
  57. simply because I can easily copy or rename the file in the batch file.  So
  58. I copy it in the next statement in my batch file to HELLO5.BBS so that
  59. my callers get to see it each time they logon.  But the choice is yours!
  60.  
  61. DESQVIEW, WINDOWS AND DOS SHARE
  62.  
  63.         Unfortunately the program contains no file sharing code and therefore
  64. will quit with an error if it cannot lock the entire user database file.  No
  65. damage will occur but the program will fail and drop to DOS.  Which still
  66. allows it to be used in your CAT.BAT file.  In the future I will address this
  67. issue.  I run a multi-line version and have to drop both nodes in an event
  68. in order to run my own program.  I also use Desqview which does not help in
  69. the file sharing catagory.  I also have DOS SHARE loaded as well, to no
  70. avail.  If you run a single-line version, you have it made running my program.
  71. If you run a multi-line system like myself, you will have to drop all nodes
  72. to run this program.  I manage to run it as an event after midnight when
  73. both nodes drop for maintenance.  OK, I know, its a pain, but if I had BTREE
  74. Filer, I could easily support the file sharing!
  75.  
  76. REGISTRATION
  77.  
  78.         In order to register the program, put $1.00 in an envelope and
  79. mail it to the address listed below.  This allows me to afford the cost of
  80. BTree Filer and write some really good utilities rather than having to hand
  81. code most of the database access routines.  After registering you can call
  82. my BBS and download a version without all the [UNREGISTERED] junk in it.  If
  83. you want to get really ambitious, for $10 I will let you download the entire
  84. source code which needs only Turbo Pascal to compile, no other third-party
  85. libraries were used.
  86.  
  87.  
  88.                         Michael P. Kelly
  89.                         1801 Ronstan Drive
  90.                         Killeen, TX  76542
  91.  
  92. Disk Cache BBS   Node 1   (817) 554-2732  1:395/10  USR HST Dual Standard
  93.                  Node 2   (817) 554-6762            SupraModem 2400
  94.  
  95. FREQ newest version under MAGICNAME of OMLCAT
  96.